Installing and Running Part Editors(OD Cookbook)

Inside Macintosh: OpenDoc Cookbook /: Chapter 1 - Development Environment

Installing and Running Part Editors
This section explains how to install and run OpenDoc part editors.

Installing Part Editors
The result of building your part (that is, compiling your source code and linking it with the OpenDoc and Mac OS system libraries) is a shared library file. You should place this file in the Editors folder as described in the previous section.

Creating Stationery
You create stationery for your part editor by dropping the shared library file resulting from your build process on the OpenDoc application. The OpenDoc installer places the OpenDoc application in a folder named OpenDoc Libraries, which is inside the Extensions folder in the Mac OS System folder. OpenDoc places the stationery file in the Stationery folder at the root level of the startup volume.

Creating Documents
On the Mac OS platform, users create documents in three ways: by launching a part editor's stationery file from the Finder (by double-clicking it or selecting and opening it), by choosing the New command from the Document menu when an OpenDoc document is running (the new document is the same kind as the root part of the frontmost window), or by dragging a selected content object or embedded part to the desktop in the Finder (the new document has the dragged part or content as its root part).
The new document is created in the same folder as the previous document or, if that is not possible, on the desktop. The new document is named by the category of the root part or the name of the stationery from which it is created. If more than one document by this name would exist, the new document name has an integer appended indicating its place.

Running Parts
Mac OS users launch documents by double-clicking them or selecting and opening them in the Finder. OpenDoc locates and launches each part editor required to display and manipulate the root part of the document and each part, if any, embedded within it.